BBS Toolkit/BBS Toolkit.iso/doors_1/move320.zip/MOVE.DOC

Text File | 1992-02-16 | 16KB | 519 lines

                             Documentation for

                             MOVE version 3.20

                   A Pseudo Directory Maintenance Utility

                   Copyright (c) 1990, 1992 by James Held

                             February 16, 1992




















Notice:

     You are free to distribute MOVE without any modification, meaning all
original files are to be included.

     Although previous evaluation versions of MOVE were fully functional,
I have been forced to release this limited demo version. The main reason
for this policy change is due to people not registering software they use.
I have also noticed that most unregistered user can't even find the time to
tell me of any problems they might be having with the software thus making
it hard to fix bugs as they arise.

     You are free to try MOVE.  Although the trial version of MOVE has all
the features, you are limited to 10 file areas in your MOVE.CTL file, and
you can not pass MOVE an alternate .CTL or .FAR file name.  I feel this will
allow you to get the feel of this package.  If you feel you like MOVE, and
would like continue using it, you are required to PAY for it.

     You have two options when purchasing MOVE.

     Option 1:  Diskless   transfer.   MOVE 3.20  will  be
                enclosed in  message for  you to  download
                on <T>he <S>erial <P>ort BBS [phone]
                within  one  week  of  receiving  payment.
                The cost for this option is $25.00 (US)

     Option 2:  Disk mailing.  MOVE 3.20 will  be  mailed
                to you on a 5.25"  360k  disk  within two
                weeks of receiving payment.
                The cost for this option is $28.00 (US)

To purchase a registered copy of MOVE using a check or money order:

     Send the required amount for your option choice, your name, and
     address to:

         James Held
         P.O. Box 180681
         Utica, MI  48318

To purchase a registered copy of MOVE using VISA, Master Card, or Discover:

     Call the Serial Port BBS [phone] and hit P from the main menu.


The registered version will be the same, except for the inclusion of your
name at start up, support for up to 88 file areas, and use of alternate .CTL
or .FAR files.

     If you have already registered a previous version of MOVE, a registered
version of 3.20 will be  enclosed in a message for you at <T>he <S>erial
<P>ort BBS.  If you call and can't find it, please leave me a message.


Overview:

     This program was written for obvious reasons, it's a pain to copy
files from one directory to another, erase it, load your P-Dir into a
word processor, then add it to your list.

     Before you run MOVE, you must have ANSI.SYS loaded.  This is quite
important as MOVE fully utilizes ANSI for it's display.  This also means
MOVE version 3.20 will run via a type 44 or a remote drop to DOS on MLTBBS
allowing remote Sysop's to fully maintain upload/download areas.

   Files included: MOVE.EXE The actual program, version 3.20
                   MOVE.CTL Sample configuration file
                   MOVE.DOC This file

  Setting up MOVE:

   Setting up MOVE is very easy, all you'll need is a simple text editor
such as EDLIN.  You can either edit the existing control file you received
with MOVE, start your own, or use a .FAR file (providing it's ANSI free).
Please note, if you use your control file from version 2.0, you'll have to
remove the color setup line.

Creating a control file:

   You can create a control file giving it any name you like.  The default
file MOVE will try to open is MOVE.CTL, you can however, pass MOVE any control
file name via the command line. (i.e. MOVE GIF.CTL)  This optional use of
control files helps out if you have remote Sysop's who only require access
limited file areas.  Any one control file can have up to 88 different file
areas.

   To create an entry, simply enter the full path and file name or your
pseudo file, then a space, then a short description of each area.  Both
file name and description are required.  You may also add comment lines
using a ; or a ! as your first character.
                   A sample entry might look like this:
                   C:\BBS\UTIL\FILES.DIR IBM Utilities
















Running MOVE:

     Providing everything is set up right, you are now ready to run the
program.  After the program loads it will ask you for a area to take files
from, you simply type the number of the area you wish to work with.

    The screen will display everything you want to know about the file entry,
including file size and date.  On the bottom of the screen you will notice a
'status bar' of sorts, this will tell you your current work file, which entry
is currently displayed, and a total number of records.  The record number
display will turn yellow to indicate the displayed record has extended
description lines, the file name will turn yellow to indicate the current
record has a pathed file.

    As you edit your list, move files, etc. you will notice the 'move tag' in
the upper left corner of the screen, this will display what has been done to
the file, if you make a mistake and move it to the wrong area, the Untag
command comes in very handy.




































    MOVE menu options can be displayed via the '?' command at the prompt.  All
commands are described in detail below.


<; or +>  These commands will both move you forward one line in your pseudo
          directory, if you have comment lines, MOVE will skip them until
          it finds a file entry.  NOTE: Your Down Arrow key will also work
          if you are running move from the console.

     <->  This command will move you backward one entry, like forward it will
          skip over any comment lines.  Up Arrow will also work from the
          console.

     <G>  Go to line.  This will allow you to jump to a specified line, if
          you enter a line number, and that line happens to be a comment
          line, MOVE will go to the next highest line.

     <M>  Move a file.  This command will tag a file to be moved.  All files
          are moved when exiting the program or changing work areas.
          Using the move command will kill the original file and delete the
          entry only if there is enough disk space on the destination drive.
          MOVE will retain the original creation time/date of the moved file.

     <D>  Delete entry/file.  This command will allow you to delete files
          and pseudo entries.  When using the Delete command, MOVE will
          ask you if the actual disk file should be delete also, if you
          answer no, the entry will be tagged for deletion and the file
          will not be touched.  To allow deleting files for disk space
          purposes MOVE will delete the file instantly and tag the
          entry as *Deleted*.  You can use the Untag command to undelete
          the pseudo entry, but once the file is deleted, it's gone!

     <E>  Edit entry.  This command will allow you to edit the DOS directory
          name, the pseudo name, upload by, and description.  When editing
          the DOS directory name, MOVE will change the actual file name on
          your disk, then will ask you if the pseudo name should be the same.
          MOVE fully supports extended descriptions, but you will only be
          able to edit/display the first line.
















     <S>  Sort pseudo list.  This command will sort your pseudo directory
          alphabetically or by date.  Sorting by date will put newest files
          on the top of the list.  The sort option will sort between
          comment lines and drag extended descriptions along with it's
          parent record.
          Thus:
          ;
          ; This is the IBM file area.
          ;
          ; All files on this system are PAK'ed and require the latest version
          ; of PAK to unsqueeze them.
          ;
          ZZZ.PAK ZZZ.PAK 'JAMES HELD' A great game!
          !>Requires EGA/VGA
          AAA.PAK AAA.PAK 'JAMES HELD' Great disk utility
          !>Works with hard disks only!
          !>Oh yeah, use with DOS 3.XX
          ;
          ; File archivers
          ;
          PAK251.EXE PAK251.EXE 'JAMES HELD' Latest version of PAK
          !>Use to extract all files on this system.
          INFO.PAK INFO.PAK 'JAMES HELD' PAK information file.

          When sorted by pseudo name will become:

          ;
          ; This is the IBM file area.
          ;
          ; All files on this system are PAK'ed and require the latest version
          ; of PAK to unsqueeze them.
          ;
          AAA.PAK AAA.PAK 'JAMES HELD' Great disk utility
          !>Works with hard disks only!
          !>Oh yeah, use with DOS 3.XX
          ZZZ.PAK ZZZ.PAK 'JAMES HELD' A great game!
          !>Requires EGA/VGA
          ;
          ; File archivers
          ;
          INFO.PAK INFO.PAK 'JAMES HELD' PAK information file.
          PAK251.EXE PAK251.EXE 'JAMES HELD' Latest version of PAK
          !>Use to extract all files on this system.

     <F>  Find a string.  This command will find a entry using the string
          you input.  The find command will search directory name, pseudo
          name, uploaded by, and description fields for the string.  The
          Find command searches forward of your currently displayed record.

     <U>  Un-tag.  This command will untag a entry.




     <R>  Redisplay screen.  Mainly for on-line use, will clear and
          repaint the screen.

     <I>  Internal MOVE.  This command will allow to move the current
          record anywhere within the current pseudo directory.

     <T>  Type.  This will toggle between entry type.  Types supported
          are standard and the new alternate format.

     <H>  Hide file, put a '*' in front of the entry so TBBS will not
          display it.

     <*>  Show disk free space of a given drive.

     <X>  Cross reference.  This command will check your DOS directory
          against your pseudo directory.  You will be prompted to enter
          a path to cross reference, if your files are pathed to another
          directory, enter the full path name, if your files reside in the
          directory as your .DIR file, simply hit return. I would not
          suggest using this command if you have more then 1 pseudo directory
          in a disk directory.  If MOVE finds a file on the disk that is not
          in the pseudo list, you will then have the option to add it, delete
          it, skip it, or quit.  The Cross reference command works great for
          adding new entries.

     <V>  Verbose listing of PAK/ARC/ZIP/GIF file.  This command will allow
          you to list files in a PAK, ARC, or ZIP file.  You can also use this
          command to display the resolution and colors of a GIF file.

     <C>  Change work file.  This command will save all changes, move all
          files, then give you the option to load a different pseudo file.

     <Q>  Same as change but will end program.

     <A>  Abort will exit MOVE without saving any changes.



















Some helpful hints:

          MOVE can only have one tag per entry.  If you wish to move a hidden
    file, MOVE will remove the hidden tag and replace it with the area name.
    If you still want the file hidden, you must then load the work file you
    moved it to then use the hide file command.

          MOVE works great for backing up files to floppies.  MOVE will ONLY
    move files that will fit, therefore, if you run out of disk space, not
    to worry MOVE will ignore that file and go onto the next until it has
    tried them all.  MOVE will also move descriptions and create the pseudo
    list for you.

          The Untag command is a life saver, it can be used to 'reset' the
    status of any file.

          MOVE works great when importing files.  To import files, copy them
    into the desired directory and use the cross reference function, when
    MOVE gets to that file, it will ask you if you want to add it to your
    pseudo directory.

          If you do not have a 'uploaded by' field, MOVE will add one
    for you.  MOVE will add 'Sysop'.

          If you have a problem or suggestions, feel free to leave me a
    message on the Serial Port BBS [phone].  All support of this
    product and MOVESL will be handled through The Serial Port.



























Move 3.xx release history

   February 16, 1992

     MOVE version 3.20 released.


        Support for larger control files implemented.

        Up arrow and down arrow keys no work to move through .DIR files.

        ZIP and GIF file supported in the <V>erbose command.

        Support for TBBS 2.2 alternate format .DIR files added.
          MOVE will now sense if an entry is an 'alternate' type entry. You
          may also change the entry type via the T command.

        Support for alternate directories on cross reference added.

        Quit function in Cross Referencing added

        More error checking added.

        Apostrophe in Uploaded field bug fixed.

        Last line in .DIR file being comment display bug fixed.

        Move will now increment one record after you move a file.


   November 18, 1990

     MOVE version 3.10 released.

        Support added for pathed files.

          MOVE will now strip redundant pathing information only.  This
          means, if your file has the same path as your .DIR file, the path
          will be removed, otherwise it will be left alone.  If the displayed
          file is pathed, the DOS file name will be displayed using the color
          yellow, the actual path will not be displayed. When moving a pathed
          file, only the P-Dir entry will be moved, the actual file will not.

        Find command changed.

          The Find command will now search ahead of your currently displayed
          record.







        Full support for .FAR files.

          MOVE will now use pretty much any FAR directory as it's control
          file.  Move will ignore flags and comments.  Move will not support
          FAR files with ANSI.

        Internal MOVE command added.

          This command will allow you to move lines within your active working
          directory allowing you to move files between comment blocks.

        Lockup bug fixed.

          Version 3.0 would sometimes lock up under certain conditions.  This
          has been taken care of.

        Disk space bug fixed.

          When checking for disk space while help was displayed, MOVE version
          3.0 would erase the first line containing the drive name you
          checked.  This bug has been fixed.



   October 10, 1990 - Version 3.0
     MOVE version 3.0 released.  MOVE 3.0 represents a total rewrite.  Support
for larger files, on-line use, sorting between comments with extended
description support.